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Overview 


The Cooler Master Maker Toolbox is a software development kit that gives you complete 
access to the code behind LED lighting on all of our peripheral products. With the controls 
in your hands and the ability to retrieve system data from your PC, your lighting can be 
programmed to change, for example, according to the music you play or the speed of your 


processor. Create a whole host of effects using basic C++ knowledge. 


Share your profiles with other Cooler Master peripheral owners at 


http://makerhub.coolermaster.com 
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SDK Package 


Example Folder: 


(I) Example directory content 
1. Sample execution file 
2. Sample source code; 
3. Sample description 
(11) SDK directory content 
1. CoolerMaster LED Table.xls: LED Matrix (7 row x 24 Column) 


2. x86 directory: dynamic link libraries, Lib file and header file 
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Requirements 


Windows 7 (32-bit and 64-bit); 


Windows 8.1 (32-bit and 64-bit); 


Windows 10 (32-bit and 64-bit). 


Supported Devices 


Device 


Keyboard 


Mouse 


Headset 


Accessory 


MasterKeys Pro L 
MasterKeys Pro M 
MasterKeys Pro S 
MasterKeys Pro L White 


MasterKeys Pro M White 


MasterKeys Pro S White 
MK750 


MasterMouse Pro L 
MasterMouse Pro S 
MM520 
MM530 
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Reference 


SDK Related Definitions 


LED Matrix SIZE 
MAX_LED_RO:7 
MAX_LED_COLUMN:24 


struct KEY_COLOR { 
BYTE r; 

BYTE g; 

BYTE b; 

J; 
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struct COLOR_MATRIX { 


Description: set/store entire LED Color structure 
KEY COLOR KeyColor[MAX LED ROW][MAX LED COLUMN]; 
}; 


enum EFF_INDEX { 


Description: set/store entire LED Color structure Special effects list 
EFF FULL ON = 0, EFF_BREATH = 1, 

ЕЕЕ BREATH CYCLE = 2, EFF_SINGLE = 3, 
EFF WAVE = 4, EFF RIPPLE - 5, 

EFF CROSS = 6, ЕРЕ RAIN = 7, 

ЕЕЕ STAR = 8, ЕРЕ SNAKE = 9, 

EFF REC = 10, 

EFF INDICATOR = 13 

ЕЕЕ MULTI 1 = OxEO, 

EFF MULTI 2 = OxE1, ЕЕЕ MULTI 3 = OxE2, 
ЕЕЕ MULTI 4 = OxE3, ЕЕЕ OFF = OxFE}; 
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System data related function 


TCHAR * GetNowTime() 


Description: Obtain current system time 

Function name : GetNowTime 

variable: 

return : TCHAR : string index format is %Ү %m/%d 96H:96M 96S 


note: 


LONG GetNowCPUUsage(DWORD * pErrorCode = NULL) 


Description: obtain current CPU usuage ratio 

Function name: GetNowCPUUsage 

variable : DWORD * pErrorCode : return the error code 
returns : LONG : 0 ^ 100 integer 


note : 
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DWORD  GetRamUsage() 


Description: Obtain current RAM usuage ratio 
Function name: GetRamUsage 

variable : 

returns : DWORD : 0 ^ 100 integer 


note : 


float GetNowVolumePeekValue() 


Description: Obtain current volume 
Function name : GetNowVolumePeekValue 
variable : 

returns : float : 0 ^ 1 float number 


note : 
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Device operation function 


Void SetControlDevice(DEVICE_INDEX devindex) 


Description: set default operating device 
Function name: SetControlDevice 
variable : DEVICE INDEX: device list 
DEV MKeys і, 

DEV МкКеус S, 

DEV MKeys L White 

DEV MKeys M White 

DEV MMouse L 

DEV MMouse S 

DEV MKeys M 

DEV MKeys S White 

DEV MM520 

DEV MM530 

DEV MK750 
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returns: 


note : 
bool IsDevicePlug(DEVICE_INDEX devlndex = DEV_DEFAULT) 


Description: verify if the deviced is plugged in 
Function name : IsDevicePlug 


variable : DEVICE_INDEX devlndex : target device 
returns: bool : true plugged in > false not plugged in 


note : 
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LAYOUT_KEYOBARD GetDeviceLayout(DEVICE_INDEX devindex = DEV_DEFAULT) 


Description: Obtain current device layout 
Function name: GetDeviceLayout 

variable : DEVICE_INDEX devindex : target device 
returns: LAYOUT_KEYOBARD List: 

currently З LAYOUT_UNINIT, 

LAYOUT US,LAYOUT EU 


note: 


bool EnableLedControl(bool bEnable , DEVICE INDEX devindex = DEV DEFAULT) 


Description: set control over device's LED 
Function name: EnableLedControl 
variable : bool bEnable: 
true Controlled by SW, 
false Controlled by FW, 

DEVICE INDEX devindex : target device 
returns : bool : true Success ,false Fail 


note : User could switch the effects when the function send the false value. 
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bool SwitchLedEffect(EFF INDEX iEffectIndex , DEVICE INDEX devindex = 


DEV_DEFAULT) 


Description: switch device current effect 
Function name: SwitchLedEffect 
variable : EFF_INDEX iEffectIndex: index value of the effect 


DEVICE INDEX devindex : target device 
returns : bool : true Success » false Fail 


note : 


bool SetFullLedColor(BYTE r, BYTE g, BYTE b ,DEVICE INDEX devindex = 


DEV DEFAULT ) 


Description: set entire keyboard LED one color 

Function name : SetFullLedColor 

variable : BYTE r :red, BYTE g :green, BYTE b :blue 
DEVICE INDEX devindex : target device 


returns : bool : true Success » false Fail 


note : 
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bool SetAllLedColor(COLOR MATRIX colorMatrix, DEVICE INDEX devindex = 


DEV DEFAULT ) 


Description: Set Keyboard "every LED" color 
Function name: SetAllLedColor 
variable : COLOR MATRIX colorMatrix:structure, 
fill up RGB value according to LED Table 

DEVICE INDEX devindex : target device 
returns : bool : true Success ,false Fail 


note : 


bool SetLedColor(int iRow, int iColumn, BYTE r, BYTE g, BYTE b,DEVICE INDEX 


devindex = DEV. DEFAULT ) 


Description: Set single Key LED color 
Function name: SetLedColor 
variable: int iRow: row, 

int iColumn:column BYTE r :red, 
BYTE g :green, BYTE b :blue 


DEVICE INDEX devindex : target device 


returns : bool : true Success » false Fail 
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note : 


bool EnableKeyInterrupt (bool bEnable,DEVICE INDEX devindex = DEV_DEFAULT ) 


Description: To enable the call back function 


Function name: EnableKeylInterrupt 

variable: bool bEnable: true enable > false disable 
DEVICE INDEX devindex : target device 

returns : bool : true Success > false Fail 


note : will call the call back function of SetKeyCallBack() 


void SetKeyCallBack(KEY CALLBACK callback,DEVICE INDEX devIndex = 


DEV DEFAULT); 

Description: Setup the call back function of button 

Function name: SetKeyCallBack 

variable: KEY CALLBACK callback call back setup › 
please reference the def of KEY CALLBACK 


DEVICE INDEX devindex : target device 


note : 
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typedef void (CALLBACK * KEY_CALLBACK)(int iRow, int iColumn, bool 
bPressed); 


Description: User could setup the callback function. It will return the status of button’s 


position when the button status change. 
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SDK example 


SDK examples illustrate 


Examples UI screen 


#2 SDKExample Ver:15 x 


System Infomation 


System Time: |2017 07/25 23:32 05 | 


CPU Usage: Ram Usage: Volume Peek: o | 


Select Device: MasterKeys Pro L v| | Set Layout: [ | Get 


LED Control LED Effect Choose: Full ON v| | Set 


Set LED color for every key 


Row: 0 “ Column: 0 “ 
Set Single Key Set ALL Key | 
Set All LED 
Set color 
C key Effect 


PS: If Key Effect Function is enable, the KEY_DOWN will be ignored. 
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Development environment: VC ++ 2008 


1. System Information: for the user's computer to fetch the local system time, CPU 
usage, memory usage percentage, the current playback volume percentage. 

2. Select Device: to select the device that you want to control, the default option is 
MasterKeys Pro L. 

3. LED Control: can choose from enable and disable, in the disable state can switch 
effects; in the enable state can setup the keyboard LED color 

4. Set LED Color for every Key: is allowed to set different colors of each key, there are 
two ways to set up. One is to set a single Key; the other one is to set all keys on the 
keyboard to specified / different color. Please use the drop-down menu and select 
Row Column with "CoolerMaster LED Table.xls" table to determine the location 
specified color. 

5. Set All Led: set the whole keyboard as a single color quickly. 


6. Set the Key effect : if it enable and the button status change, the Led of key will light. 
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